MarkLogic 9 Product Documentation
DELETE /manage/v2/forests/{id|name}

Summary

Delete a forest.

URL Parameters
level	The type of state change to initiate. Allowed values: `full`, `config-only`. A `config-only` deletion removes only the forest configuration; the data contained in the forest remains on disk. A `full` deletion removes both the forest configuration and the data.
replicas	Determines how to process the replicas. Allowed values: `detach` to detach the replica but keep it. `delete` to detach and delete the replica.

Response

Upon successful completion, MarkLogic Server returns status code 204 (No Content). A status code of 401 (Unauthorized) is returned if the user does not have the necessary privileges.

Required Privileges

This operation requires one of the following:

the manage-user role
the following privilege:
http://marklogic.com/xdmp/privileges/manage
the manage role plus one of the following granular privileges:
- http://marklogic.com/xdmp/privileges/admin/forest
- http://marklogic.com/xdmp/privileges/admin/forest/forest-ID

Example


$ curl --anyauth --user user:password -X DELETE -i \
    http://localhost:8002/manage/v2/forests/example?level=full

==> The forest named "example" is deleted, along with all of the data 
    it contained. MarkLogic Server responds with headers similar to
    the following:

HTTP/1.1 204 No Content
Server: MarkLogic
Content-Length: 0
Connection: Keep-Alive
Keep-Alive: timeout=5

MarkLogic 9 Product DocumentationDELETE /manage/v2/forests/{id|name}

Summary

Response

Required Privileges

Example

MarkLogic 9 Product Documentation
DELETE /manage/v2/forests/{id|name}